IBM zPDT Product Activation


ITC 1090 dongle/Code Authentication Procedure


With the availability of zPDT Version GA 10.6 (driver level 55.16 or later) & GA 11 (driver level 57.16 or later) the authentication process has changed.


Processing Notes




zPDT version GA 11 (driver 57.16 or later) & 10 ( driver 55.16 or later)

The z1090 software must be installed on your Linux machine. The installation can be done without using the token. You will need a working token to run the z1090 software.

Create the Request File

  1. Connect your token to a USB port (on your 1090 machine). If you are using more than one token on your system, you will be asked to select the token you would like to work with. Note: You may have a zPDT system/instance running when you do this request.

  2. Open a Gnome or Xfce terminal/command (text mode) window


  1. The request_license program must be run in root mode. Use the “ su -

command to change to root mode. Provide the root password when prompted.


  1. Change to the /usr/z1090/bin directory: “cd /usr/z1090/bin


  1. Execute the request_license. This should produce a small binary file, with a system-assigned file name, such as <linux host name>_<hash>.zip which is placed in /root. Prefix the name of the program with “./” to tell Linux to execute it from the current directory.


NOTE: If multiple Gen2 tokens are present, it will ask you to select the one you want to work with.


  1. Attach the request file to an email and send it to: support@itconline.com



Put together, the sequence would look like this in the Gnome or Xfce terminal window:


Shape1

su -

<root password>


cd /usr/z1090/bin


./request_license

exit exit

< to exit root mode >

< to close the terminal window >










ITC will process your request file and you will receive an ITC e-mail.

Update your z1090 Token

With your z1090 token connected to a USB port on your 1090 machine. If you are using more than one token on your system, you do not have to remove any tokens while updating a specific license. Note: Your zPDT system/instance can be running when you do this update.

  1. Transfer the update file to your zPDT machine.

  2. Open a Gnome or Xfce terminal/command (text mode) window

  3. The update_license must be run in root mode. Use the “ su - “ command to

change to root mode. Provide the root password when prompted.


  1. Change to the /usr/z1090/bin directory: “cd /usr/z1090/bin


  1. Execute the update_license program with the filename and full path to the update file. Prefix the name of the program with “./” to tell Linux to execute it from the current directory.


“./update_license /home/ibmsys1/<linux host name>_<hash>_update.zip”


  1. You should see multiple “Success” messages indicating the token has been updated.


  1. To verify the decryption licenses have been applied, use the

query_license command: “./query_license


  1. Leave root mode: “exit”


Shape3

su -

<root password>


cd /usr/z1090/bin


./update_license /home/ibmsys1/<linux host name>_<hash>_update.zip



./query_license

exit

exit

< to exit root mode >

< to close the terminal window >

Shape4

Your token is now ready to use.

Put together, the sequence would look like this in the Gnome or Xfce terminal window:

Shape2

Procedures last updated 2024 January 11